Frames and Facets (OD PG)

Inside Macintosh: OpenDoc Programmer's Guide / Part 2 - Programming

Chapter 3 - Frames and Facets
This is the first of eight chapters that discuss the OpenDoc programming interface in detail. This chapter focuses on the key concepts of how parts use frames and facets to accomplish embedding and to communicate with each other during layout and display.
Before reading this chapter, you should be familiar with the concepts presented in Chapter 1, "Introduction to OpenDoc," and Chapter 2, "Development Overview." For additional concepts related to your part editor's runtime environment, see Chapter 11, "OpenDoc Runtime Features."
This chapter starts with a general discussion of frames and facets, and then describes

how your part uses its display frames and facets to function as an embedded part in an OpenDoc document
how your part can negotiate with its containing part for modifications to its display frames

If your part is a noncontainer part, these are the only parts of this chapter you need to read. If, however, you are developing a container part, you also need to read the remainder of this chapter. It describes

how to negotiate with your embedded parts for modifications to their display frames
how to otherwise manipulate the frames and facets of your embedded parts

For a general summary of the embedding process, see "Adding an Embedded Part"For a summary of embedding capabilities that must be implemented by container parts, see also Appendix A, "Embedding Checklist."

Chapter Contents

Frame and Facet Hierarchies

Frames and Parts

Facets

Working With Your Display Frames and Facets

Responding to Reconnected and Closed Display Frames

Responding to Added or Removed Facets

Resizing a Display Frame

Requesting an Additional Display Frame

Responding to an Added Display Frame

Removing a Display Frame

Responding to a Removed Display Frame

Grouping Display Frames

Synchronizing Display Frames

Adopting Container Properties

Frame Negotiation

Working With Embedded Frames and Facets

Providing an Embedded-Frames Iterator

Creating a New Embedded Frame

Adding an Embedded Frame on Request

Resizing an Embedded Frame

Removing an Embedded Frame

Reconnecting and Releasing Embedded Frames

Adding a Facet

Removing a Facet

Creating Frame Groups

Synchronizing Embedded Frames

Transmitting Your Container Properties to Embedded Parts